**************************************
* Name Object - Generating C# Sample *
**************************************


---------
Overview
---------

This TXT file contains directions on how to create a prototype GUI application of Name Object's interface using the .NET API.

------------
Sample Code
------------
The sample source code files required to run this tutorial are available on the DQ Suite disk. If you've run the install on the disk, these files can also be found in the '.../Melissa Data/DQT/NameObj/samples/NET/CSharpNet' folder.
Sample Code contents:
   - Properties folder
   - Form1.cs
   - Form1.Designer.cs
   - Form1.resx
   - Program.cs
   

---------
Software
---------

The following software is required to complete this tutorial:
   - Name Object local API
   - Microsoft Visual Studio 2005 - 2012
   
--------------------------------------------------
Generating the Sample in Microsoft Visual Studio
--------------------------------------------------

1. Open Visual Studio and begin a new VS project
       Go to: File > New > Project
	   
2. The New Project wizard will start up. On the left, select 'Visual C#'. On the right, select 'Windows Forms Application'.
Select the folder location you would like this sample to save into along with the name of your sample project and press OK (this will automatically populate the Solution name with the same name)
	   
***NOTE***
If you are using VS2012, make sure '.NET Framework 4' is selected on the top drop-down.
	   
3. The Form1.cs [Design] tab will open and you will see a blank form.
   
***NOTE***
For VS2012 users, you may need to close the 'Form1.cs[Design]' tab from the project window in order to successfully run the next step
		
4. From the Solution Explorer, right click the project and choose
    Add > Existing Item...
		
5. Browse to the directory containing the Properties folder, Form1.cs, Form1.Designer.cs, Form1.resx and Program.cs. Select all these files and press the 'Add' button
   
A dialog window will pop up asking if you want to replace the existing file with the same name. Check 'Apply to all items' and select 'Yes'.
		 
A second dialog window may open asking if you want to reload the file which has been modified. Select 'Yes to All'
		 
6. Select Build > Configuration Manager.
The Configuration Manager window will open.
'Debug' may be selected as the 'Active solution configuration' by default, which you may leave as-is.
'Any CPU' may also be selected as the 'Active solution platform' by default, which you may leave as-is or force to a particular architecture (x64 or x86).
		 
Press 'Close'
		 
7. Next we're going to add the necessary DLLs (dynamic link library). In Windows Explorer, go to the directory where the Melissa Data products were installed (usually 'C:\ProgramFiles') and navigate to '...\Melissa Data\DQT\NameObj'
Depending on your system architecture, copy the 'mdName.dll' found in the 'dll_32bit' or 'dll_64bit' folder
		 
Paste this DLL into the '...\bin\Debug' folder of your project
		 
8. Navigate to '...\Melissa Data\DQT\NameObj\samples\NET'.
Depending on your system architecture, copy both the 'mdNameNET.dll' and 'mdNameCS.dll' found in the 'x64' or 'x86' folder
		 
Paste this DLL into the '...\bin\Debug' folder of your project
		 
***NOTE***
The DLLs found in these folders were compiled using the Visual Studio 2012 compiler and require the Visual Studio 2012 redistributable to be installed. If you do not have this redistributable installed, use the DLLs of the same name found in the '...\Melissa Data\DQT\NameObj\interfaces\NET' folders.
		 
9. In Visual Studio, right-click your project and choose 'Add Reference'. Browse to your project's 'bin\Debug' folder and select 'mdNameNET.dll'
   
10. Right-click 'Form1.cs' in the Solution Explorer in Visual Studio and choose 'View Code'. 
Make sure 'dFILELOC' is set to the directory containing the Melissa Data data files
Make sure 'dLICENSE' is set to the license string given to you by a sales representative, or make sure your environment variable MD_LICENSE is set.

11. You can now run the project. On the menu bar, click the green arrow , or go to 'DEBUG > Start Debugging'. The sample 